home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d22 / eyermv24.arc / MV.DOC < prev    next >
Text File  |  1991-04-01  |  11KB  |  238 lines
  1.                                 MV 2.4
  2.  
  3.                            A Fast File Mover
  4.                     with wildcard shortcut support
  5.                      and directory removal option
  6.  
  7.                                   by
  8.                                Bob Eyer
  9.                               Apr 2, 1991
  10.  
  11.  
  12.      Syntax
  13.      ------
  14.  
  15.      MV SourceFile [TargetPath] [D]
  16.  
  17.      SourceFile
  18.         is a filename or a filespec specifying what is to be moved.  It
  19.         may  be  a  single  filename or wildcard, as well as a shortcut
  20.         such  as  '..\.',  '.',  'C:.',  or even 'C:' or a subdirectory
  21.         name.
  22.  
  23.      TargetPath
  24.         is  the destination where the files will be moved.  Again, this
  25.         parameter supports all  DOS  wildcard  shortcuts,  such  as  is
  26.         supported  by  DOS  COPY and DEL, and will detect DOS's default
  27.         path for a non-local drive, just as does COPY and DEL.
  28.  
  29.         In  the  event that TargetPath is not mentioned, MV will assume
  30.         that the target is the local (default) directory, as does COPY.
  31.  
  32.      D
  33.         an  optional  parameter  which,  if specified, will cause MV to
  34.         attempt to remove the subdirectory mentioned in SourceFile.
  35.  
  36.         If D is specified, a TargetPath *must* be mentioned; otherwise,
  37.         MV will interpret D as a target subdirectory.
  38.  
  39.      New:
  40.      MV 2.4 uses a copy routine which is much faster than the one  used
  41.      in  MV  2.0,  a  routine  which  moreover  allowed  a  substantial
  42.      reduction in EXE size despite adding new features to the  program.
  43.      The  cost  of  these  advantages,  however, is higher minimum load
  44.      size.  The new minimum load size (mostly  for  large  buffers)  is
  45.      42K, compared to 9K in MV 2.0.
  46.  
  47.      Discussion
  48.      ----------
  49.      There are many file movers in the PD/shareware market;  some  much
  50.      smaller  than  MV  2.4,  others  considerably  larger  in size and
  51.      sporting   menus.    However,   the   smallest   of   the    genre
  52.      characteristically do not support DOS wildcard shortcuts, and only
  53.      a  few  of the larger ones offer consistent such support.  This is
  54.      the primary reason why I wrote this little utility.  I  got  tired
  55.      of  having to type 'MOVE *.* WORK' every time I wanted to transfer
  56.      everything in the local directory to  the  WORK  subdirectory.   A
  57.      command  like  that  should  go like this: 'MV . WORK' saving,  in
  58.      principle, two keystrokes, just like a COPY shortcut.  I also  got
  59.      tired  of  having to move into a subdirectory in order to transfer
  60.      them back again.  I  wanted  it  to  function  just  like  a  COPY
  61.      command, so that I could say things like 'MV WORK' and get all the
  62.      files back again without having to switch directories.
  63.  
  64.      MV requires video input only for confirm/no confirm on overwriting
  65.      a  file  and  for interrupting processing, where the user wants to
  66.      break execution immediately after moving the current file.  But in
  67.      both cases, console input  is  redirectable  (so  MV  can  be  run
  68.      remotely  through  a communications gateway) and uses just one key
  69.      (no ENTER key).  The Space Bar is used for user interrupt.  Y  (or
  70.      y) is used for confirm on overwrite.
  71.  
  72.      The  best  way  to check out MV is to treat it exactly like a COPY
  73.      command; there should  be  no  difference,  except  for  the  file
  74.      renaming  function  of  COPY:  MV does not support moving a source
  75.      file to a target area with a different base name specified on  the
  76.      commandline.
  77.  
  78.      A short discussion of examples follows:
  79.  
  80.      Suppose  we  have  a file called ABC.EXE in directory \COMPILE and
  81.      we've been working in directory  \COMPILE\ABC  to  compile  a  new
  82.      version  of  ABC.EXE.  We now wish to update the COMPILE directory
  83.      version.  MV handles the job nicely:
  84.  
  85.      MV *.exe ..
  86.  
  87.      This command will direct the new EXE  file  to  be  moved  to  the
  88.      parent  directory  and  will  result  in  an  overwrite situation.
  89.      Hitting Y in response to the prompt will cause the overwrite.  The
  90.      video display will be:
  91.  
  92.      ..\ABC.EXE exists.  Overwrite? [Y/N]y
  93.      1 file(s) moved
  94.  
  95.      Note  the  confirming message '1 file(s) moved'.  MV always issues
  96.      either this confirmation with the number of files affected or  the
  97.      message  'No  file(s)  moved' where no action was taken, say where
  98.      the source files are not either  Archive  or  Reset  status  (i.e.
  99.      where they are Read Only, Hidden, or System).
  100.  
  101.      Where the target file to be overwritten is Read Only, the  attempt
  102.      to overwrite will cause no action to be taken, and there will be a
  103.      message that the target file was not deleted.  The reason for this
  104.      is  that,  before  each overwrite, MV first attempts to delete the
  105.      target file, in preparation for the new write.  If it  cannot,  it
  106.      just returns with the appropriate diagnostic message.
  107.  
  108.      Other examples
  109.      --------------
  110.      MV ABC.DOC C:LM          Moves ABC.DOC to the LM subdirectory
  111.                               of the default directory of C:
  112.  
  113.      MV c:lm\abc.doc          Moves ABC.DOC back from the LM
  114.                               subdirectory of the default path of C:
  115.                               (Notice that this example has no explicit
  116.                                target path, and is assumed to be the
  117.                                default directory.)
  118.  
  119.      MV XYZ C:\               Moves XYZ to the root directory of C:
  120.  
  121.      MV XYZ C:                Moves XYZ to the default directory of C:
  122.  
  123.      MV . ..\A                Moves everything in the current directory
  124.                               to  the  A  subdirectory  of  the current
  125.                               directory's parent.
  126.  
  127.      MV . ..\..\B             Moves everything in the current directory
  128.                               to the  B  subdirectory  of  the  current
  129.                               directory's grandparent.
  130.  
  131.      MV ..\..\B               Moves everything in the B subdirectory
  132.                               of the current directory's grandparent to
  133.                               the current directory.
  134.  
  135.      MV W . D                 Moves everything in the W subdirectory
  136.                               to the current directory and then removes
  137.                               the W subdirectory.
  138.  
  139.      Errors
  140.      ------
  141.      MV thoroughly accounts for all errors and displays each associated
  142.      with the file being operated on.
  143.  
  144.      1.  No  parameters  on  the  command  line.  In this case, MV will
  145.          return a short help screen and DOS error level of 1.
  146.  
  147.      2.  No files satisfying the Source filespec.  MV will  return  the
  148.          message 'No such file(s)' and error level of 1.
  149.  
  150.      3.  Space bar is hit.  MV responds by  halting  with  the  message
  151.          'Processing interrupted' and error level of 1.
  152.  
  153.      4.  Source  file  has the Read Only, Hidden, or System attributes.
  154.          MV takes no action, issuing a 'Check attribute' message.
  155.  
  156.      5.  Copy/rename operation not complete or erroneous.   MV  returns
  157.          the message that the source file has not been copied, proceeds
  158.          to  delete  any  possible  remnant  in the target area, with a
  159.          message about no deletion if not complete,  and  then  returns
  160.          control to the next entry.
  161.  
  162.      6.  MV detects duplicate in target area.  See Example 1 above for
  163.          discussion.
  164.  
  165.  
  166.      For  speed,  MV  moves  files  by  renaming rather than by copying
  167.      material byte for byte, where the Source and Target specifications
  168.      do  not  contain  any  reference  to  drives.   Where  drives  are
  169.      mentioned,  however,  MV  uses  straight copying of material, even
  170.      where the same drive is mentioned in the source  and  the  target.
  171.      The  speed  advantage  of version 2.4 relates specifically to this
  172.      copy mode.
  173.  
  174.      DISCLAIMER:
  175.      ==========
  176.      This program is circulated as freeware without  any  guarantee  or
  177.      warranty;  and  the  user,  by  downloading  this  program, or any
  178.      variant thereof or by receiving it or any of its versions  in  any
  179.      other  form, agrees to accept full responsibility for its use.  It
  180.      is therefore understood that the user accepts this program or  any
  181.      previous version as is.
  182.  
  183.      Bob Eyer                  The author may also be reached at
  184.      Compuserve [73230,2620]   ROSE MEDIA 416-733-2285 (Main Conf)
  185.      Toronto                   CMIX 416-277-2363 (Main Conference)
  186.      Canada                    CANADA REMOTE 416-629-7044 (IBM Conf)
  187.      -----------------------------------------------------------------
  188.      End of documentation.
  189.  
  190.          ----------------end-of-author's-documentation---------------
  191.  
  192.                          Software Library Information:
  193.  
  194.                     This disk copy provided as a service of
  195.  
  196.                            Public (software) Library
  197.  
  198.          We are not the authors of this program, nor are we associated
  199.          with the author in any way other than as a distributor of the
  200.          program in accordance with the author's terms of distribution.
  201.  
  202.          Please direct shareware payments and specific questions about
  203.          this program to the author of the program, whose name appears
  204.          elsewhere in  this documentation. If you have trouble getting
  205.          in touch with the author,  we will do whatever we can to help
  206.          you with your questions. All programs have been tested and do
  207.          run.  To report problems,  please use the form that is in the
  208.          file PROBLEM.DOC on many of our disks or in other written for-
  209.          mat with screen printouts, if possible.  PsL cannot debug pro-
  210.          programs over the telephone, though we can answer questions.
  211.  
  212.          Disks in the PsL are updated  monthly,  so if you did not get
  213.          this disk directly from the PsL, you should be aware that the
  214.          files in this set may no longer be the current versions. Also,
  215.          if you got this disk from another vendor and are having prob-
  216.          lems,  be aware that  some files may have become corrupted or
  217.          lost by that vendor. Get a current, working disk from PsL.
  218.  
  219.          For a copy of the latest monthly software library newsletter
  220.          and a list of the 3,000+ disks in the library, call or write
  221.  
  222.                            Public (software) Library
  223.                                P.O.Box 35705 - F
  224.                             Houston, TX 77235-5705
  225.  
  226.                                  Orders only:
  227.                                 1-800-2424-PSL
  228.                               MC/Visa/AmEx/Discover
  229.  
  230.                           Outside of U.S. or in Texas
  231.                           or for general information,
  232.                               Call 1-713-524-6394
  233.  
  234.                           PsL also has an outstanding
  235.                           catalog for the Macintosh.
  236.  
  237.  
  238.